home *** CD-ROM | disk | FTP | other *** search
/ Aminet 48 / Aminet 48 (2002)(GTI - Schatztruhe)[!][Apr 2002].iso / Aminet / util / misc / KeyMapEd.lha / KeyMapEd.full_readme next >
Encoding:
Text File  |  2002-02-15  |  8.9 KB  |  193 lines
  1. Short       : Keymap editor (old program, but it works!)
  2. Uploader    : Fulvio Peruggi <peruggi@unina.it>       
  3. Author      : Tim Friest
  4. Type        : util/misc
  5. Replaces    : KeyMapEd V1.1i
  6. Version     : 1.2
  7. Requires    : AmigaOS 1.3 or higher
  8. Distribution: Aminet
  9.  
  10.  
  11. A simple and efficient tool to edit keymaps at will, for example to make
  12. Euro-compatible any old custom keymap.
  13.  
  14.  
  15.                   This is the original readme by the author:
  16. +----------------------------------------------------------------------------+
  17. | Key Map Editor by Tim Friest                                               |
  18. |                                                                            |
  19. | This disk contains the source and executable to the KeyMapEd program.      |
  20. |                                                                            |
  21. | KeyMapEd is copyright © 1989,1990 by Tim Friest                            |
  22. | The program is FreeWare, and may be copied or distributed in any manner as |
  23. | long as there is no charge for the program (nominal charges for media,     |
  24. | handling or BBS fees are allowed).                                         |
  25. |                                                                            |
  26. | Please send all comments/suggestions/bug reports to                        |
  27. |                                                                            |
  28. | USMail: Tim Friest                   BITNet: AXTBF@ALASKA.BITNET           |
  29. |         3861 Steller Dr.                                                   |
  30. |         Anchorage, AK 99504          BIX: TFriest                          |
  31. |                                                                            |
  32. | Voice:  (907) 333-8199                                                     |
  33. +----------------------------------------------------------------------------+
  34.  
  35.  
  36. In these days of the Euro a little interest has grown about fonts and keymaps.
  37. Amiga Inc. and Haage&Partner Computer GmbH have recently provided updated
  38. fonts and keymaps, so we have a reference standard for the creation of new
  39. Euro-compatible fonts and keymaps. While a number of good font editors are
  40. present on Aminet and elsewhere, the same is not true for keymap editors. As
  41. far as I know, only the following packages are available on Aminet:
  42.  
  43.  KeyMapEd.lha      Aminet Set 1a (utils/misc)
  44.  kme.lha           Aminet Set 1a (utils/misc)
  45.  EditKeys163.lha   Aminet Set 3a (utils/misc)
  46.  
  47. EditKeys is more recent (1993) but less powerful than KME (1992) and KeyMapEd
  48. (1991).
  49.  
  50. KME works, but it uses the ROM coded Topaz 8 fonts to show the image of the
  51. (displayable) character associated to any given key. This is convenient, but
  52. is also somewhat confusing. Indeed KME is able to manage the interchange of
  53. <ALT>e and <ALT>y keys needed for Euro-compatibility, but it still displays
  54. the Topaz 8 pre-Euro symbol instead of the Euro symbol for the &A4 code. (If
  55. you use MCP, you can activate its "ReplaceTopaz" option pointing to an
  56. Euro-updated font set, to display the Euro symbol).
  57.  
  58. KeyMapEd is not affected by this problem, because it correctly displays only
  59. the hexadecimal code associated with each key or combination of keys (i.e.
  60. just the data that really are present in the keymap edited). It works fine,
  61. but its archive present on Aminet:util/misc contains only the program without
  62. documentation. It is possible to find complete original archives on the good
  63. old Fish Disks, namely:
  64.  
  65.  KeyMapEd V1.0     Fish Disk 193
  66.  KeyMapEd V1.1i    Fish Disk 388
  67.  
  68. Therefore, since the utility was declared FreeWare by the author, I decided
  69. to upload onto Aminet a complete package for all the people interested.
  70.  
  71. Actually the present archive is more than a plain collection, because I have
  72. used always a slightly more recent version of KeyMapEd, unissued both on
  73. Aminet and Fish Disks. This version, KeyMapEd V1.2, actually seems to be
  74. version 1.1i recompiled: the only visible change is that the more recent
  75. version of the program does not open a blank tiny window (besides the
  76. Load/Edit/Save windows and the GUI) when it is run. (The totally unuseful
  77. blank window, that opened in the start phase, was a frequent characteristic of
  78. many early utilities). I presume that KeyMapEd V1.2 was compiled by Tim
  79. Friest, but actually I have no reliable information about this. Unfortunately
  80. I don't remember at all how I obtained this version: more than ten years
  81. passed since then...
  82.  
  83. In conclusion, the present package has been assembled by me as follows:
  84.  
  85. >>> KeyMapEd V1.0 sources extracted from Fish Disk 193
  86. >>> KeyMapEd V1.1i documentation extracted from Fish Disk 388
  87. >>> KeyMapEd V1.2 binary extracted from my own hystorical archives
  88.  
  89. Have fun with it.
  90.  
  91.    Fulvio Peruggi
  92.  
  93.  
  94. ******************************************************************************
  95. Let me send many thanks to Tim Friest for his still useful work, wherever he,
  96. the author, is now!
  97. ******************************************************************************
  98.  
  99.  
  100. Note 1:
  101. KeyMapEd V1.2 is dated March 1991, but it works perfectly on my Amiga 4000
  102. equipped with Kickstart 40.68 (3.1), Workbench 45.2 (3.9), 68060/50MHz,
  103. PPC/233MHz (well... the program does not use the PPC processor :-) ). However
  104. KeyMapEd is a very old program, and erroneously assumes that the screen font
  105. is Topaz 8, so the GUI appears a bit dirty if you use bigger screen fonts
  106. (which is very likely, today). The simplest thing to do, if you want to see a
  107. perfect GUI, is to use the Font preferences program of AmigaOS to set
  108. temporaneously the screen font to Topaz 8 before launching KeyMapEd. (The best
  109. thing to do would be a specific patch to force KeyMapEd to load Topaz 8
  110. instead of the actual screen font: is anyone out there able to create it?)
  111.  
  112.  
  113. Note 2:
  114. If you have any keymap not provided by Amiga Inc. and Haage&Partner Computer
  115. GmbH, and want to make it Euro-compatible, do the following:
  116.   1) Run KeyMapEd and load the keymap needed (it must be into DEVS:Keymaps).
  117.   2) Point the "e" key on the KeyMapEd GUI and click: the key edit window
  118.      opens.
  119.   3) You should read the code \xa9 on the right hand side of both the <Alt>
  120.      line and the <Shift+Alt> line.
  121.   4) Click on the character 9 of the first \xa9 code, delete 9, type 4, press
  122.      <RETURN>.
  123.   5) Click on the character 9 of the second \xa9 code, delete 9, type 4, press
  124.      <RETURN>.
  125.   6) Now you should see the code \xa4 on the right hand side of both the <Alt>
  126.      line and the <Shift+Alt> line. Press the <Use> button. The key edit
  127.      window closes.
  128.   7) Point the "y" key on the KeyMapEd GUI and click: the key edit window
  129.      opens.
  130.   8) You should read the code \xa4 on the right hand side of the <Alt> line.
  131.   9) Click on the character 4 of the \xa4 code, delete 4, type 9, press
  132.      <RETURN>.
  133.  10) Now you should see the code \xa9 on the right hand side of the <Alt>
  134.      line. Press the <Use> gadget. The key edit window closes.
  135.  11) Press the right mouse button and choose Project/Save in the KeyMapEd
  136.      menu: the Save window opens. Now:
  137.      - either press the <Save> button: the edited keymap will overwrite the
  138.        old one;
  139.      - or BETTER change the name of the keymap and press the <Save> button:
  140.        the edited keymap will be saved with the new name chosen.
  141.  12) Quit KeyMapEd.
  142. That's all! Now your edited keymap is Euro-compatible (of course you must
  143. activate it and also need an Euro-compatible font set to actually see the Euro
  144. symbol when you press <ALT>e or <SHIFT><ALT>e).
  145. For any other question concerning the most general use of the program, please
  146. refer to the original documentation.
  147.  
  148.  
  149. Note 3:
  150. Please note that the OS does not load a keymap whose filename is the same as
  151. the filename of an already loaded keymap! Commands like SetMap or SetKeyboard
  152. only load keymaps with completely new names. In such a case, to force loading,
  153. a reboot is needed. Otherwise, to avoid the reboot, you should use an utility
  154. like LoadKeymap V1.1, that you can find in the above-mentioned EditKeys
  155. package.
  156.  
  157.  
  158. ------------------------------------------------------------------------------
  159.  
  160. A brief technical description:
  161.  
  162. When you type on the keyboard, the device generates keyboard codes; the
  163. computer interprets these keyboard codes and generates specific hexadecimal
  164. codes (or even whole strings of hexadecimal codes) according to the keymap
  165. used; the character(s) actually displayed on screen are extracted from the
  166. font set used, according to the hexadecimal code(s) generated.
  167.  
  168. In other terms a keymap is a translation table: you enter keyboard codes and
  169. it outputs hexadecimal codes. A font set is a display table: you enter
  170. hexadecimal codes and it outputs character images. For example, the following
  171. occurs when you type <ALT>e or <ALT>y with old/new keymaps/fonts:
  172.  
  173.  
  174. Keystrokes    Keymap        Hex code    Fonts        Character
  175.         used        generated    used        dispayed
  176.  
  177.  
  178. <ALT>e        old        &A9        old        Copyright
  179. <ALT>y        old        &A4        old        Pre-Euro
  180.  
  181. <ALT>e        old        &A9        new        Copyright
  182. <ALT>y        old        &A4        new        Euro
  183.  
  184. <ALT>e        new        &A4        old        Pre-Euro
  185. <ALT>y        new        &A9        old        Copyright
  186.  
  187. <ALT>e        new        &A4        new        Euro
  188. <ALT>y        new        &A9        new        Copyright
  189.  
  190.  
  191. (Here "new" means Euro-updated).
  192.  
  193.